JR63396: DOC - THE "THRESHOLD-FOR-EXISTING-USER-RETRIEVAL-MODE" CONFIG PROPERTY SAMPLE AND THE "VMM-OPTIONS" ARE MISSING

APAR status

• Closed as documentation error.

Error description

• The sample for configuring
  <threshold-for-existing-user-retrieval-mode> provided at
  "Synchronizing users between the Business Automation Workflow
  database and the user registry"
  (https://www.ibm.com/support/knowledgecenter/SS8JB4_20.x/com.ibm
  .wbpm.admin.doc/topics/sync_users.html) is incorrect. It is
  missing the <vmm-options> element:
  
  <common merge="mergeChildren">
    <security>
     <threshold-for-existing-user-retrieval-mode
  merge="replace">1000</threshold-for-existing-user-retrieval-mode
  >
    </security>
  </common>
  
  The syntax in the sample at "Configuring the user registry"
  https://www.ibm.com/support/knowledgecenter/SS8JB4_19.x/com.ibm.
  wbpm.imuc.doc/topics/managing_users_extsecprov.html is correct:
  
  <common merge="mergeChildren">
    <security>
      <vmm-options>
  
  <threshold-for-existing-user-retrieval-mode>1000</threshold-for-
  existing-user-retrieval-mode>
      </vmm-options>
    </security>
  </common>
  
  PRODUCTS AFFECTED
  IBM Business Automation Workflow
  

Local fix

Problem summary

• The sample for configuring
  <threshold-for-existing-user-retrieval-mode> provided at
  "Synchronizing users between the Business Automation Workflow
  database and the user registry"
  (https://www.ibm.com/support/knowledgecenter/SS8JB4_20.x/com.ibm
  .wbpm.admin.doc/topics/sync_users.html) is incorrect. It is
  missing the <vmm-options> element:
  
  <common merge="mergeChildren">
    <security>
     <threshold-for-existing-user-retrieval-mode
  merge="replace">1000</threshold-for-existing-user-retrieval-mode
  >
    </security>
  </common>
  
  The syntax in the sample at "Configuring the user registry"
  https://www.ibm.com/support/knowledgecenter/SS8JB4_19.x/com.ibm.
  wbpm.imuc.doc/topics/managing_users_extsecprov.html is correct:
  
  <common merge="mergeChildren">
    <security>
      <vmm-options>
  
  <threshold-for-existing-user-retrieval-mode>1000</threshold-for-
  existing-user-retrieval-mode>
      </vmm-options>
    </security>
  </common>
  
  PRODUCTS AFFECTED
  IBM Business Automation Workflow
  

Problem conclusion

• The content will be updated the next time the documentation is
  refreshed.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels